From f9ed6baeb46ce07b86ed23fe60eef8e94552f77d Mon Sep 17 00:00:00 2001
From: Carlos Garnacho <carlosg@gnome.org>
Date: Wed, 15 Dec 2010 03:33:01 +0100
Subject: [PATCH] Improve docs for gtk_widget_reset_style().

Document that it may be needed in containers when
children are reordered.
---
 gtk/gtkwidget.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 317b45b3c2..05ea17bc9e 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -8689,7 +8689,9 @@ reset_style_recurse (GtkWidget *widget, gpointer data)
  * @widget: a #GtkWidget
  *
  * Updates the style context of @widget and all descendents
- * by updating its widget path.
+ * by updating its widget path. #GtkContainer<!-- -->s may want
+ * to use this on a child when reordering it in a way that a different
+ * style might apply to it. See also gtk_container_get_path_for_child().
  *
  * Since: 3.0
  */
-- 
2.30.2